home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds.fmt / gr2ps.man < prev    next >
Encoding:
Text File  |  1989-11-17  |  5.9 KB  |  199 lines
  1.  
  2.  
  3.  
  4. GR2PS                UNKNOWN MANUAL SECTION                 GR2PS
  5.  
  6.  
  7.  
  8. NNAAMMEE
  9.      _g_r_2_p_s - convert Gremlin files to PostScript
  10.  
  11. SSYYNNOOPPSSIISS
  12.      _g_r_2_p_s [ -n ] [ -p _X _Y ] [ -s _X _Y ] [ -t _X _Y ] [ _i_n_p_u_t ]
  13.  
  14. DDEESSCCRRIIPPTTIIOONN
  15.      This program takes a picture description produced by the
  16.      Gremlin picture editor and converts it a PostScript page
  17.      that can be printed on any printer that supports this
  18.      language, such as the Apple LaserWriter.  _G_r_2_p_s handles the
  19.      different types of elements in this Gremlin output to pro-
  20.      duces a good looking page on a LaserWriter.
  21.  
  22.      It takes the name of a Gremlin file (default is standard
  23.      input) and writes the resulting PostScript file to its stan-
  24.      dard output, unless the -o option (see below) is given, in
  25.      which case it writes to the specified file.
  26.  
  27.      _G_r_2_p_s produces a file that can be included into another page
  28.      description.  This is meant to be used when a PostScript
  29.      file is being imbedded into a document of another type (such
  30.      as TeX, using \special).  If the file is to be printed
  31.      directly, the user must add a call to sshhoowwppaaggee to the
  32.      ``%%Trailer'' section at the end.
  33.  
  34.      The gremlin coordinates are normally coppied out directly to
  35.      PostScript coordinates (the inherited user space).  This
  36.      behavior can be modified with the -s and -t options (see
  37.      below).  Note that if scaling and translation are both
  38.      specified, the translation is performed _a_f_t_e_r the scaling
  39.      (i.e., the translation factor is not affected by the scale).
  40.      This is unlike PostScript, where the order of the operations
  41.      matters.  Also, the lower-left corner of the picture may be
  42.      placed at any location on the page with the -p option.
  43.  
  44.      By default, the four troff fonts, R, I, B and S are mapped
  45.      to the LaserWriter fonts TTiimmeess--RRoommaann, TTiimmeess--IIttaalliicc, TTiimmeess--
  46.      BBoolldd and CCoouurriieerr--BBoolldd respectively.  This action can be
  47.      changed with the -R, -I, -B and -S options.
  48.  
  49.      _G_r_2_p_s obeys of the Adobe PostScript file structuring conven-
  50.      tions.  In particular, each file begins with a set of com-
  51.      ments which introduce the file as PostScript code and
  52.      specify the bounding box of the figure along with other
  53.      information.
  54.  
  55. OOPPTTIIOONNSS
  56.      -R   set the ``roman'' font to the given LaserWriter font
  57.           (default TTiimmeess--RRoommaann).
  58.  
  59.      -I   set the ``italic'' font to the given LaserWriter font
  60.  
  61.  
  62.  
  63. Sprite v1.0                 10/20/87                            1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. GR2PS                UNKNOWN MANUAL SECTION                 GR2PS
  71.  
  72.  
  73.  
  74.           (default TTiimmeess--IIttaalliicc).
  75.  
  76.      -B   set the ``bold'' font to the given LaserWriter font
  77.           (default TTiimmeess--BBoolldd).
  78.  
  79.      -S   set the ``special'' font to the given LaserWriter font
  80.           (default CCoouurriieerr--BBoolldd).
  81.  
  82.      -n   force interpretation of the gremlin file in newer for-
  83.           mat (that produced by the Sun version) rather than the
  84.           older Gremlin format.  If the gremlin file was produced
  85.           by the Sun gremlin, this newer format is automatically
  86.           assumed.
  87.  
  88.      -o   write output to a certain file rather than the standard
  89.           output.  The -o option must take as an argument the
  90.           name of a file which it can create.
  91.  
  92.      -p   place the lower-left point of the figure at the coordi-
  93.           nate given by the two floating-point option arguments.
  94.           For example, ``-p 0 0'' can be used to place the figure
  95.           at the origin no matter where Gremlin put it.  Note
  96.           that this is a translation, so only one of -t and -p
  97.           may be specified.
  98.  
  99.      -s   scale every coordinate by the scale factor given by the
  100.           two floating-point numbers which are the option argu-
  101.           ments.  This has the effect of scaling the resulting
  102.           picture.  Using ``-s 0.75 1.0'' would scale to 75% in
  103.           the X direction and leave the Y direction scale as it
  104.           was, producing a narrower picture.
  105.  
  106.      -t   translate every coordinate by the two floating-point
  107.           numbers which are the option arguments.  Note: in
  108.           PostScript the point 0, 0 is at the left bottom corner
  109.           of the page, even though the laser writer can't actu-
  110.           ally paint at this point.  Using ``-t 10.0 10.0'' would
  111.           move the figure ten units up and to the right on the
  112.           page.  The translation is applied the coordinates have
  113.           been scaled.
  114.  
  115. SSEEEE AALLSSOO
  116.      _g_r_e_m_l_i_n(L), _g_r_n(L), _t_e_x(L)
  117.  
  118. AAUUTTHHOORR
  119.      John Coker,
  120.      University of California, Berkeley
  121.      john@renoir.Berkeley.EDU
  122.  
  123.      Peehong Chen,
  124.      University of California, Berkeley
  125.      phc@renoir.Berkeley.EDU
  126.  
  127.  
  128.  
  129. Sprite v1.0                 10/20/87                            2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. GR2PS                UNKNOWN MANUAL SECTION                 GR2PS
  137.  
  138.  
  139.  
  140. NNOOTTEESS
  141.      PostScript is a trademark of Adobe Systems, Inc.
  142.      Apple and LaserWriter are trademarks of Apple Computers.
  143.  
  144. BBUUGGSS
  145.      Because the Gremlin coordinate system is different from the
  146.      PostScript one, the -s and -t options are almost always
  147.      necessary to get the output sized and placed properly.  Of
  148.      course, they can be emulated in PostScript with the ssccaallee
  149.      and ttrraannssllaattee operators.
  150.  
  151.      The grey scale used does not really correspond in any
  152.      rational way with the set of gremlin stipples.  It would be
  153.      possible to use bit rasters in PostScript to emulate the
  154.      gremlin stipple patterns, but the author thought this of
  155.      dubious use.
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195. Sprite v1.0                 10/20/87                            3
  196.  
  197.  
  198.  
  199.